Aller au contenu principal

Développement agentique

Cette page décrit le workflow de développement assisté par IA qu'on utilise à ITN, basé sur les skills de Matt Pocock (aihero). Ces skills suivent un format standard et fonctionnent sur tous les outils de coding agentique.

Prérequis
  • Les skills Matt Pocock installés en global : 
    npx skills@latest add mattpocock/skills
  • Si tu as les "superpowers" installés, il vaut mieux les désactiver — ils peuvent interférer avec ces skills. Tu peux garder /using-git-worktrees qui reste utile.
  • Puis lance /setup-matt-pocock-skills pour configurer ton repo

Implémenter un ticket — le cas courant​

Le cas d'usage principal : tu as un ticket à implémenter.

1. Clarifier — /grill-with-docs​

Avant de coder, lance /grill-with-docs avec le lien ou la description du ticket. L'agent te pose des questions pour lever les ambiguïtés, valider ta compréhension et documenter les décisions.

En sortie :

  • Un CONTEXT.md mis à jour avec le glossaire du domaine
  • Des ADR (Architecture Decision Records) pour les choix structurants

Mieux tu clarifies en amont, moins tu corriges en aval.

2. Implémenter — /implement​

Une fois les zones d'ombre levées, /implement prend le relais. Il implémente le ticket en utilisant le TDD quand c'est possible, lance le typechecking régulièrement, et fait une /code-review automatique à la fin. Le code est committé sur la branche courante.

Créer du travail from scratch​

Quand tu pars d'une idée et qu'il n'y a pas encore de tickets.

1. Affiner l'idée — /grill-with-docs​

Même skill, usage différent. Tu décris ton idée, l'agent t'interview pour la structurer et la documenter.

2. Rédiger la spec — /to-spec​

/to-spec synthétise la conversation en une spec publiée sur ton issue tracker. Pas de nouvelle interview — il transforme ce qui a été dit en document structuré.

3. Découper en tickets — /to-tickets​

/to-tickets prend la spec et la découpe en tickets verticaux (tracer bullets) avec leurs dépendances. Chaque ticket est autonome et implémentable par un agent.

4. Implémenter — /implement​

Puis /implement sur chaque ticket, comme décrit plus haut.

Pour les gros chantiers — /wayfinder​

Quand un sujet est trop gros pour tenir dans une seule session — trop de zones d'ombre, trop de décisions à prendre — /wayfinder sert à cartographier le travail.

Il crée une "carte" sous forme d'issues sur le tracker : chaque issue est une décision à résoudre, pas une tâche à exécuter. Une fois toutes les décisions prises, la carte est complète et tu peux passer au flow principal.

Skills utiles​

/ask-matt​

Tu ne sais pas quel skill utiliser ? /ask-matt est le routeur. Décris ta situation, il t'oriente vers le bon skill.

/code-review​

Lance une revue de code automatique. Utilisé automatiquement à la fin de /implement, mais tu peux aussi le lancer manuellement sur n'importe quel diff.

/prototype​

Tu as une question qui ne se résout pas en conversation — il faut du code pour voir. /prototype produit du code jetable pour valider une idée. Ce n'est pas du code de production, c'est un outil de décision.

/teach​

Tu veux comprendre un concept, un pattern, ou un bout de code ? /teach adopte une approche pédagogique : il t'explique, te fait manipuler, et vérifie ta compréhension. Utile pour monter en compétence sur un sujet ou onboarder quelqu'un sur une partie du code.

Autres skills disponibles​

Les skills suivants sont aussi installés. Consulte la documentation aihero pour le détail de chacun :

  • /triage — catégoriser et qualifier des issues
  • /handoff — transmettre le contexte entre sessions
  • /writing-great-skills — écrire ses propres skills
  • /domain-modeling — modéliser un domaine métier
  • /tdd — développer en Test-Driven Development

Aller plus loin​

Pour une documentation complète sur les skills, les patterns et les bonnes pratiques : aihero.dev.